home *** CD-ROM | disk | FTP | other *** search
/ Acorn Risc Technologies StrongARM CD-ROM / Acorn Risc Technologies StrongARM CD-ROM.iso / ftp / makemodes / !MakeModes_Docs_MakeMan < prev    next >
Encoding:
Text File  |  1994-08-23  |  13.1 KB  |  334 lines
  1. -----------------------------------------------------------------------------
  2. MakeModes manual
  3. -----------------------------------------------------------------------------
  4. Date:   22-Aug-1994
  5. Issue:  1.00
  6. Author: Dean Murphy
  7. -----------------------------------------------------------------------------
  8. Copyright © 1994 Acorn Computers Limited 
  9.  
  10.  
  11. Every effort has been made to ensure that the information in this document is
  12. true and correct at the time of printing. However, the products described in
  13. this leaflet are subject to continuous development and improvements and Acorn
  14. Computers Limited reserves the right to change its specifications at any
  15. time. Acorn Computers Limited cannot accept liability for any loss or damage
  16. arising from the use of any information or particulars in this leaflet.
  17. ACORN, ECONET and ARCHIMEDES are trademarks of Acorn Computers Limited.
  18. -----------------------------------------------------------------------------
  19.  
  20. Introduction
  21.  
  22. MakeModes is a tool used to generate and edit Risc PC monitor definition
  23. files (MDFs). Before using  the MakeModes application, you should take the
  24. time to read the application note 'Creating monitor definition files for the
  25. Risc PC' (available upon request from Acorn Customer Services).
  26.  
  27. Overview
  28.  
  29.     The process for creating and saving a monitor definition file can be
  30.         summarised as follows;
  31.  
  32.     1  Load MakeModes
  33.  
  34.     2  Click on the MakeModes icon.
  35.  
  36.     3  Click on the 'Monitor title' menu icon and select the appropriate
  37.            monitor from the list. If your monitor is not included in the
  38.            list, enter the correct values and click on 'Generate'.
  39.  
  40.     4  Save the generated mode file to disc.
  41.  
  42.  
  43. Creating a Monitor definition file
  44.  
  45.     1  Start MakeModes in a similar way to other RISC OS applications, by
  46.            double-clicking on its application icon. When it has loaded, it
  47.            will install itself on the iconbar.
  48.  
  49.     2  Click on the MakeModes icon, this will open the 'Generate MDF'
  50.            window.
  51.  
  52.  
  53.     3  Choose a monitor by clicking on the 'Monitor title' menu icon and
  54.            selecting the appropriate monitor from the list. If the monitor
  55.            for which you are generating a set of modes is not in the list you
  56.            can enter your own set of values into the writable icons. 
  57.  
  58.        If you do wish to use a new set of values, please ensure that the
  59.            following information is correct:
  60.  
  61.     Monitor type
  62.  
  63.             The different types are listed below:
  64.  
  65.         0    50Hz TV Standard colour or monochrome monitor
  66.         1    Multiscan monitor
  67.         2    Hi-Res 64Hz monochrome monitor
  68.         3    VGA-type monitor
  69.         4    Super-VGA-type monitor
  70.         5    LCD (Liquid crystal display)
  71.  
  72.     Line rate (min and max)
  73.  
  74.     The minimum and maximum line rates for you monitor are specified in
  75.         Hz. This information can usually be found in your monitor's manual.
  76.  
  77.     Frame rate (min and max)
  78.  
  79.         The minimum and maximum frame rates are specified in Hz. This
  80.                 information can usually be found in your monitor's manual.
  81.  
  82.     4  Now click on 'Generate'. If the monitor that you have chosen is
  83.            not recognised by MakeModes, or values that you have entered do
  84.            not make sense e.g. minimum value greater than the maximum value,
  85.            you will get either of the following warnings:
  86.       
  87.            'Do you wish to add this monitor to the monitor list?'
  88.            
  89.            or
  90.            
  91.            'Nonsensical line and/or frame rate values.'
  92.  
  93.        If you do wish to add the monitor to MakeModes monitor list, click
  94.            on 'Yes', MakeModes will update its MonList file with the new
  95.            monitor information.
  96.  
  97.        If at any stage, you want to remove a monitor from the list, load
  98.            the MonList file (which can be found inside the !MakeModes
  99.            directory) into a text editor such as !Edit and delete the
  100.            appropriate line from the file.
  101.  
  102.     5  MakeModes will now select all the modes that are suitable for use
  103.            with your chosen type of monitor and open the main display window.
  104.  
  105.     6  Using the MakeModes main menu (click MENU over the main display
  106.            window) save the generated MDF to disc.
  107.  
  108.  
  109.  
  110. Loading a previously created Monitor definition file
  111.  
  112.         To load a previously created monitor definition file into MakeModes,
  113.         simply drag the file to the  MakeModes icon on the icon bar. The
  114.         title field of an MDF usually holds the name of the monitor for 
  115.         which the file was created. When MakeModes loads an MDF, it checks
  116.         this name against its own list of  monitors which it knows about. If
  117.         it finds a match, that monitor's details are used to check the
  118.         validity of the modes in the mode file. If a match is not found,
  119.         MakeModes will display a message prompting you  to select an
  120.         appropriate monitor from its stored list. You can do this by clicking
  121.         on the 'Monitor details' menu icon and selecting the monitor from the
  122.         list displayed.
  123.  
  124.  
  125. Using the main display window
  126.  
  127.     The main display window consists of six distinct areas:
  128.  
  129.                 •  File info
  130.                 •  Mode Info
  131.                 •  Screen RAM
  132.                 •  General Info
  133.                 •  Mode timings
  134.                 •  Timing diagnostics.
  135.  
  136.     We shall deal with each of these areas in turn.
  137.  
  138.     File info
  139.  
  140.     This area displays information specific to the mode definition file
  141.         as a whole.
  142.  
  143.         See diagram 'fig1'.
  144.  
  145.  
  146.         The following DPMS states can be used:
  147.  
  148.         0    DPMS disabled - screen blank just blanks video
  149.         1    Screen blank enters 'Stand-by' mode
  150.         2    Screen blank enters 'Suspend' mode
  151.         3    Screen blank enters 'Off' mode.
  152.  
  153.  
  154.     Mode info
  155.  
  156.     This area displays information on the currently selected mode. To see
  157.         a list of the modes available, click on the 'Current mode' menu icon
  158.         and select a mode from the list. Although it is possible to give
  159.         screen modes different textual name's e.g. 'DTP Mode', the modes are
  160.         listed in the menu by their resolution and frame rates e.g. 800 x
  161.         600 (60 Hz).
  162.  
  163.     When you have selected a screen mode from the list, the mode info
  164.         area will be updated accordingly.
  165.  
  166.         See diagram 'fig2'
  167.  
  168.     One of the main items that you will want to edit in this window is
  169.         the 'Pixel rate'. By altering the pixel rate, it is possible to
  170.         increase or decrease the Frame rate for a given mode. Please note
  171.         though that increasing the pixel rate will also increase the line
  172.         rate and bandwidth required.
  173.  
  174.     You can alter the 'sync polarity' using the arrow icons. The possible
  175.         values for the sync polarity are as follows:
  176.  
  177.                0    hsync normal, vsync normal
  178.         1    hsync inverted, vsync normal
  179.         2    hsync normal, vsync inverted
  180.         3    hsync inverted, vsync inverted
  181.  
  182.     When MakeModes creates a new screen mode, the name it uses for that
  183.         screen mode is derived from its resolution and frame rate. You can
  184.         give any screen mode a new name using the 'Name' icon. To do this, 
  185.         simply type a new name into the 'Name' writable icon and press
  186.         Return. If you do not want the mode to appear in the Display
  187.         Manager's mode list, simply ensure that the option icon beside the
  188.         Name icon is not ticked.
  189.  
  190.     Screen RAM
  191.  
  192.     When MakeModes is loaded, the amount of VRAM present in the machine
  193.         is shown in the Screen RAM area of the main display window:
  194.  
  195.     The amount of VRAM available dictates the machine's video bandwidth
  196.         limits. The more VRAM  available, the higher the bandwidth. If a
  197.         screen mode exceeds this bandwidth limit, the Display Manager  will
  198.         refuse to allow the mode to be used. To help prevent this happening,
  199.         MakeModes will inform you if  this limit has been exceeded by turning
  200.         the 'Bandwidth' field (see the General info section later in this 
  201.         document) red.
  202.  
  203.     If you wish to check that a mode will work on a machine with a
  204.         different amount VRAM, click on one of the VRAM icons in the 'Screen
  205.         RAM' area.
  206.  
  207.     Clicking on one of the VRAM icons will set the amount of VRAM that
  208.         MakeModes believes is available. Doing this will also update the
  209.         information in the 'General info' area i.e. the 'Memory' and
  210.         'Bandwidth' fields.
  211.  
  212.  
  213.     General info
  214.  
  215.     The General info area of the main display window shows mode
  216.         diagnostic information.
  217.  
  218.         See diagram 'fig3'.
  219.  
  220.     The number of bits per pixel (bpp) selected is shown in the 'Bits per
  221.         pixel' icon. This number can be changed by clicking on the Bits per
  222.         pixel menu icon and selecting a new value from the menu. The bpp 
  223.         setting affects the screen memory and bandwidth calculations e.g. an
  224.         800 x 600 screen mode in 8 bpp (256 colours) takes 468K of screen
  225.         memory and has a required bandwidth of 36MB/sec. The same mode  in
  226.         32bpp (16 Million colours) takes 1875K of screen memory and has a
  227.         required bandwidth of 144MB/ sec. If the memory or bandwidth fields
  228.         turn red, the limits have been exceeded. That mode will not work  at
  229.         the selected pixel depth. For more information on pixel depths,
  230.         please refer to the 'Creating mode definition files for the Risc PC'
  231.         application note.
  232.  
  233.     Mode timings
  234.  
  235.     The 'Mode timings' area of the main display window is used to alter
  236.         the horizontal and vertical timings  for the selected mode. The
  237.         timings values can be updated by using either the arrow icons or by
  238.         clicking on one of the writable icons and typing the new value.
  239.  
  240.         See diagram 'fig4'.
  241.  
  242.         As timing values are altered, MakeModes will recalculate the Pixel,
  243.         Frame and Line rates automatically. If any of the timing values are
  244.         incorrect, MakeModes will show the changes that need to  be made in
  245.         the Timings diagnostics area.
  246.  
  247.     NOTE: Because the 'Memory' and 'Bandwidth' values are not updated
  248.         automatically, you must click on one of the VRAM icons when changes
  249.         have been made to the Pixel rate or the mode timings.
  250.  
  251.     When you are happy with your mode timings, you may wish to centre the
  252.         picture on screen. This can be done by increasing or decreasing the
  253.         'porch' and 'border' values. If the 'Keep porch and border' totals 
  254.         icon is ticked MakeModes will retain the overall totals by
  255.         subtracting or adding the same amount to the opposite porch or
  256.         border. e.g. increasing the Left border by 12 will decrease the Right
  257.         border by 12. This option only works when the arrow icons are used to
  258.         alter the timing values.
  259.  
  260.  
  261. The iconbar icon
  262.  
  263.     The iconbar icon responds to the mouse in the following ways:
  264.  
  265.     •  clicking Select on the icon opens the 'Generate MDF' window if no
  266.            MDFs are currently being edited. If an MDF is being edited,
  267.            clicking Select on the icon will bring the main window to the
  268.            front of the window stack.
  269.  
  270.     •  clicking Menu on the icon opens the MakeModes menu.
  271.  
  272.     •  clicking Adjust on the icon has no effect.
  273.  
  274.     •  Dragging an MDF to the icon will load the MDF if no modefile is
  275.            currently being edited.
  276.  
  277.  
  278. The MakeModes icon bar menu
  279.  
  280.     Info displays the 'Program Info' dialogue box.
  281.     
  282.     VESA selects VESA standard mode timings.
  283.  
  284.     Quit exits the program. When you quit the application, a warning box
  285.         may be opened if there is any unsaved data.
  286.  
  287.             Clicking on Discard will discard any unsaved data.
  288.  
  289.             Clicking on Cancel will cancel the request to quit the
  290.                 application.
  291.  
  292.             Clicking on Save will open the normal RISC OS Save as
  293.                 dialogue box allowing you to save your data.
  294.  
  295.  
  296. The MakeModes main menu
  297.  
  298.     Save MDF leads to a 'Save As' dialogue box that will allow you to
  299.         save your MDF to disc or to another  application using the normal
  300.         RISC OS method.
  301.  
  302.     Generate list leads to a 'Save As' dialogue box. This option will
  303.         allow you to save a list of modes that are  present in the current
  304.         MDF. This list is saved in TAB separated plain text format that can
  305.         be loaded into any text editor or desktop publisher.
  306.  
  307.     Monitor info leads to the monitor info dialogue box. The Window info
  308.         dialogue box displays information on the currently selected monitor.
  309.  
  310.     New mode will make a copy of the currently selected mode. If you are
  311.         intending to generate a  completely new mode, it is always a good
  312.         idea to choose an existing mode that most closely matches the mode
  313.         that you wish to create.
  314.  
  315.     Delete mode will delete the currently selected mode. This operation
  316.         cannot be undone.
  317.  
  318.     Comments will send any comments that were found in the current MDF to
  319.         a text editor such as !Edit where they can be edited and dragged
  320.         back to the 'Comments' icon in the main display window for inclusion
  321.         in the saved MDF.
  322.  
  323. Disclaimer
  324.  
  325.     The software is provided "as is"; Acorn Computers Limited ("Acorn")
  326.         makes no warranty, express or  implied, of the merchantability of
  327.         this software or its fitness for any particular purpose. In no 
  328.         circumstance shall Acorn be liable for any damage, loss of profits,
  329.         or any indirect or consequential loss arising out of the use of this
  330.         software or inability to use this software, even if Acorn has been
  331.         advised of the possibility of such loss.
  332.  
  333.     Acorn are unable to provide any support for this utility.
  334.